home *** CD-ROM | disk | FTP | other *** search
/ Amiga Tools 4 / Amiga Tools 4.iso / tools / internet-tools / httpirl-log / httpirlog.doc < prev    next >
Encoding:
Text File  |  1996-02-26  |  6.4 KB  |  211 lines
  1. Short:    HTTPD Logfile Analyzer by PirlAGA
  2. Uploader: alessandro@mca.shiny.it (PirlAGA)
  3. Author:   tekne@cmns.mnegri.it (PirlAGA)
  4. Type:     comm/net
  5.  
  6. WHAT IS IT?
  7. -----------
  8. This is just a Beta Version of an HTTPD Logfile Analyzer 
  9. & Web Connections Statistics Maker, written by PirlAGA.
  10.  
  11. This Program allows you to process the logfile of the World 
  12. Wide Web servers programs (httpd = HTTP Daemons) and to get 
  13. Stats.
  14.  
  15. WHY?
  16. ----
  17. I've decided to write this program because i was curious to know
  18. Stats about my Web site, but there are no Amiga Programs that do
  19. It.
  20.  
  21. I've decided to release this beta version so you can help me to
  22. find bugs (if they are), to test it with different logfiles and 
  23. to suggest me new functions to add.
  24.  
  25. I think to release a MS-DOS version too, to get more users, but 
  26. AmigaOS is The Best Operating System Ever.
  27.  
  28. WHAT KIND OF DATA?
  29. ------------------
  30. I've just tested it with the Logfile of the CERN httpd, and the
  31. program seems to work correctly.
  32.  
  33. I haven't found logfiles of other daemons, so i cannot test my
  34. program with this.
  35.  
  36. If you have other type of HTTPD-logfile, like that of NCSA 
  37. httpd, please contact me SOON, so i can learn about it and teach 
  38. to my progam to recognize and process it.
  39.  
  40. FUNCTIONS
  41. ---------
  42. At the actual state, this programs allows you to know:
  43.  
  44. - How many requests for each page,
  45. - How many connections from each domanin,
  46. - How many connections in each time band,
  47. - How many connections in each day, month or year.
  48.  
  49. The program shows stats on the screen, and produces an output file 
  50. by default (.PIRL) too, so you can read the stats later too.
  51.  
  52. The program shows how many pages are listed in the logfiles, and 
  53. how many of these are processed for creating stats.
  54.  
  55. The program calculates the time it taked to get operations too.
  56.  
  57. TO DO
  58. -----
  59. - I'll implement the function to specify a wildcard extesion of
  60.   pageames to process.
  61.  
  62. - Next thing to do, is to write a more friendly user interface.
  63.  
  64. - I hope to be able to sort and tabulate output stats of pages, 
  65.   domains and time bands.
  66.  
  67. - Catalogs support.
  68.  
  69. - Special Additions & Keyfile Detecting for registered users.
  70.  
  71. - I'll add all functions you will suggest to me, if possible, so
  72.   write to me soon!
  73.  
  74.  
  75. THE ARCHIVE
  76. -----------
  77. HTTPirLOG      10.2 Kbytes  The Main Executable  
  78. HTTPirLOGwb     2.0 Kbytes  A Simple WB Interface (written in AmigaDOS)
  79.                             with some error in Flag Parameters 
  80. HTTPirLOG.doc   6.3 Kbytes  This DocFile
  81.  
  82. I've tested the program on standard A1200 and A3000  with 2, 3 & 4Mb 
  83. httpd-logfiles, and it seems to work correctly.
  84.  
  85. USAGE
  86. -----
  87. The program is CLI only; if you run it without parameters, it shows 
  88. you the "Usage parameters" list. 
  89.  
  90. If you enter "-h" or "-H" as first parameter, you will get the Online
  91. step-by-step Help.
  92.  
  93. The first parameter have to be the filename, the others may have random 
  94. order. Parameters (except PageBase), are case unsensitive.
  95.  
  96. You can also use the HTTPirLOGwb script, that provides to open window
  97. requesters and to give a littlebit more friendly interface; but remember
  98. the errors in that scripts.
  99.  
  100. Usage: HTTPirLOG
  101.        FILENAME/A    File To Check
  102.        NOLOG/S       Don't Create Logfile
  103.        NOELAPSED/S   Don't Show Elapsed Time
  104.        PROGRESS/S    Show Progress
  105.        JUSTHTML/S    Stats for .HTML Pages Only
  106.        CLASS=N/S     Domain Level
  107.        DATE=N/S      Date Depth
  108.        BAND=NN/S     Time Band Depth
  109.        PAGE=XXX/S    Page or Directory Name
  110.  
  111.        HTTPirLOG -H  For The OnLine Help
  112.  
  113.  FILENAME
  114.   The only necessary parameter is the FILENAME of the logfile to 
  115.   process, who have to be the first entry after the programname.
  116.  
  117.  NOLOG 
  118.   This is a flag. If presents, tells to the program to not Create 
  119.   the Output file.
  120.  
  121.  NOELAPSED
  122.   Another Flag. Tells to the Program to not calculate the elapsed 
  123.   time in the process.
  124.  
  125.  PROGRESS
  126.   Flag to enable the progress showing.
  127.  
  128.  JUSTHTML
  129.   Flag to tell to the program to process .HTML files only.
  130.  
  131.  CLASS=N 
  132.   this parameter needs a numerical value after the = .
  133.   It represents the class of domains to process, and
  134.   maybe a number from 0 to 9. The 0 disables this function.
  135.   The default value is 1.
  136.  
  137.   EG: class=1  processes  .it  domains
  138.       class=2  processes  .cmns.it  domanis
  139.       class=2  processes  .mnegri.cmns.it  domains
  140.       etc.
  141.  
  142.  DATE=N
  143.   this contains a numerical value that tells to the program
  144.   what kind of dates to analyze. The range is 0 .. 3, 0 disables
  145.   this function. Default is 1.
  146.  
  147.   EG: date=1  is for  Day/Month/Year
  148.       date=2  is for  Month/Year
  149.       date=3  id for  Year only
  150.  
  151.  BAND=NN
  152.   this flag is for time bands size. It maybe 0, 15, 30 or 60.
  153.   0 disable this function, default is 60.
  154.  
  155.   EG: band=60  for  1 hour bands
  156.       band=30  for  30 mins bands
  157.       band=15  for  15 mind bands
  158.  
  159.  PAGE=XXX
  160.   this is the indicator of the most important function, the "pages
  161.   to process" indicator.
  162.   0 disables the pagenames processing.
  163.   Any other string will be accepted as a pagename or a base-directory
  164.   name: the program will process only pages in specified directory, or
  165.   just the specified page.
  166.   All other Stats will refer to This pages.
  167.   For HomeUsers directory, you can entry both ~ or %7E qualifiers.
  168.  
  169.   EG: page=/~tekne/welcome.html - program will make stats for this
  170.                                   file
  171.  
  172.       page=/ridere/           \__ program will process the files in  
  173.       page=ridere             /   ridere directory only.
  174.  
  175. Examples:
  176.  
  177.  HTTPirLOG httpd.log
  178.    Output file (httpd.log.PIRL) Enabled, TimeCount Enabled, time bands 
  179.    of 1 hour, date type is Day/Month/Year, domains type is .it , do not
  180.    show progress, assuming all pages, 
  181.  
  182.  HTTPirLOG httpd2.log class=2 band=15 noelapsed justhtml progress page=/ridere/
  183.    Output file (httpd2.log.PIRL) enabled, domains type is cmns.it
  184.    time bands are 15 mins long, do not calculate time elapsed, date
  185.    type is still Day/Month/Year. Show progress, process just .HTML
  186.    pages from the /ridere/ directory. 
  187.  
  188. BUGS
  189. ----
  190. - For numerical domains it's not so nice to see just numbers, but
  191.   it comes from the logfile and from the caller's machine.
  192.  
  193. - My bad english.
  194.  
  195. LEGAL & AUTHOR
  196. --------------
  197. This Program is EveryThingYouWant-Ware, that means you
  198. can send me Every Thing You Want to get Registered In
  199. Future Versions.
  200.  
  201. To refer bugs and suggestions, you can contact me via 
  202.  
  203. e.Mail: tekne@cmns.mnegri.it 
  204.         alessandro@mca.shiny.it
  205.  
  206. i hope to hear from you soon!
  207.  
  208. Look'up my Web at http://www.cmns.mnegri.it/~tekne/
  209.  
  210. See ya, aMiGa RulEz!
  211.